home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 3 / Cream of the Crop 3.iso / utility / csap421.zip / READ.ME < prev    next >
Text File  |  1994-02-25  |  8KB  |  162 lines

  1. CSAP - Sort And Pack Directories [C source]
  2.  
  3. Author:  Don A. Williams
  4.  
  5. Version: 4.2.1   Date:    February 25, 1994
  6.  
  7. Fixed  a  bug that appeared when the TRUNCATE option was specified and  there
  8. where just enough active entries in a directory to require an integral number
  9. of  clusters  -  in  this case,  CSAP attempted to write  out  one  too  many
  10. clusters.   Some minor, cosmetic changes were also made.   There have been no
  11. reports  of  CSAP  use with any of the disk compression  facilities  such  as
  12. DoubleSpace, Stacker, or SuperStore yet and I don't use any of them.  Be VERY
  13. careful if you use CSAP with one of these facilities.
  14.  
  15. Version: 4.2.0   Date:    February  5, 1994
  16.  
  17. Finally,  the problem with large partitions appears to be fixed!   I  finally
  18. got a system with a single 200 meg partition and tracked down the bugs!   The
  19. special modifications to the absread/abswrite functions made in Version 4.1.0
  20. by  Edgar  Swank are no longer necessary.   Borland fixed  their  version  of
  21. absread/abswrite to handle partitions > 32  meg.   The major problems were  a
  22. number  of  calculations  that  should have been "long"   and  actually  were
  23. "unsigned".   This version, again,  has NOT been tested on a large variety of
  24. configurations - I only have the one system with a large partition - and must
  25. be used with care!
  26.  
  27. Version: 4.1.0   Date:    January 3, 1994
  28.  
  29. This version is another attempt to fix the problem with large partitions.   I
  30. had some external help with this one from Edgar W.  Swank.  I  have no system
  31. on  which I can test the large partitions - the largest partition on my  main
  32. system is 60meg.   Mr.  Swank located and fixed a couple of the problems  for
  33. me.
  34.  
  35.  
  36. Version: 4.0.0   Date:    September  9, 1993
  37.  
  38. This version attempts to fix the long standing problem with large partitions,
  39. i.e. FATs larger than 64k.  It MUST be considered as a "Beta" test version!
  40.  
  41.  
  42. Version: 3.2.1   Date:    September 25, 1992
  43.  
  44. This version reinstates the "truncate"  option that was destroyed by  version
  45. 3.2.0.  It also fixes a long standing error it writing the second copy of the
  46. FAT when  a  directory has been truncated.   The  version/date  printout  are
  47. corrected in this version too!
  48.  
  49. Version: 3.2.0   Date:    February 20, 1992
  50.  
  51. A  total reimplementation of the handling of erased entries  that  eliminates
  52. the "cross linked files" problem.  Evidently, some of the disk organizers pay
  53. no  attention  to  the "end of directory"  sentinel unless it occurs  at  the
  54. physical end of the directory.   CSAP now zero-sets all entries at the end of
  55. the directory.   The truncate directory option is,  temporarily,  crippled in
  56. this version.
  57.  
  58. Version: 3.1.2   Date:    February 19, 1992
  59.  
  60. Minor change in the handling of erased entries in an attempt,  only partially
  61. successful,  to eliminate the "cross linked files"  problem that occurs  when
  62. CSAP  is  used  in conjunction with some of the  "disk  organizer"  programs,
  63. notably Central Point Software's COMPRESS and the Shareware DOG.
  64.  
  65. Version: 3.1.1   Date:    February 14, 1991
  66.  
  67. Made  a  very  minor change to allow CSAP to run under   MS-DOS   5.0.    The
  68. change amounted  to nothing more than allowing "5" as a DOS version number.
  69.  
  70. Version: 3.1.0   Date:    July 11, 1990
  71.  
  72. Repaired    a    rather   major   problem   with   the    '-t',      Truncate
  73. Directories,  option   and  empty  directories.   If  there  was  a directory
  74. consisting of nothing but erased  files  and  CSAP  was executed  WITHOUT the
  75. '-t' option and,   later,   CSAP was executed WITH the '-t'  option, many bad
  76. things including corruption of the disk could occur! Also corrected the count
  77. of freed clusters which was one too high and added a count of the freed bytes
  78. to the message.
  79.  
  80.  
  81. Version: 3.0.2   Date:    June 20, 1990
  82.  
  83. Since  the  absread()  and  abswrite()  functions  provided  with version 1.0
  84. of  Borland  International's  Turbo C++  support the  long  sector  addresses
  85. required by partitions larger than 32 meg,  the special routines used by CSAP
  86. are  no  longer  needed and have  been removed.   The GetDPB()   function was
  87. recoded to  eliminate assembly language at the same time.  Added  a   message
  88. showing  the  number  of clusters freed by the "Truncate Directories" option,
  89. '-t', and fixed a small bug in the truncation routine.
  90.  
  91. Version: 3.0.1   Date:    June 18, 1990
  92.  
  93. Version 3.0.1 of CSAP is nothing more  than  a  recompilation  of CSAP  using
  94. Turbo  C++ 1.0.  It is slightly smaller and slightly faster than CSAP 3.0.0.
  95.  
  96. Version: 3.0.0   Date:    May 11, 1990
  97.  
  98. Version  3.0.0   of  CSAP can handle MS-DOS  4.xx  and  DR   DOS   3.xx large
  99. partitions.    It   also   introduces   the  optional  ability  to   truncate
  100. directories,    i.e.   release unused directory disk  space back to  the free
  101. space  pool.   CSAP now uses Chris Blum's Absolute Disk   I/O   modifications
  102. but  only   the  OBJ file for the Compact model in  included  in   the   CSAP
  103. ZIP.  The entire   package   is available  on  CompuServ  in  IBMPRO  Library
  104. #3    as ABRD40.ARC.  Version 3.0.0 of CSAP MUST be regarded as a "beta test"
  105. version  -there  are now many different possible configurations and  I   have
  106. not  been able to test them all.   It has been tested with MS-DOS 3.3  on the
  107. small partitions that 3.3  can handle and  with  MS-DOS 4.01  and DR DOS 3.41
  108. on small partitions and on large partitions up to 70  meg.    I  would highly
  109. recommend that you take a full save of your hard disk before using CSAP 3.0.0
  110. until you are sure that it works with your particular setup.
  111.  
  112. Version  2.1.1   of CSAP corrects the incorrect sorting on Date/Time that was
  113. reintroduced in CSAP 2.0.9 and  later  versions.  Thanks to David Klatzco for
  114. reporting it.
  115.  
  116. Version 2.1.0  of CSAP corrects the handling of the '.'   and  '..' directory
  117. specifiers   and  adds  the  documentation  of the '-V'  option  to  CSAP.DOC
  118. (the '-V'  has been operative in  the  program for some time but was left out
  119. of the documentation.)
  120.  
  121. CSAP  is  composed of 5 modules;   CSAP.C,  SORTDIR.C,   ISDEV.C.C, GETDPB.C,
  122. and ABSREAD.OBJ.  The current version  of  CSAP,   CSAP 3.0.0ß,    has   been
  123. designed    for  compilation  with  Borland International's  Turbo   C   2.0.
  124. The  module   ISDEV.C   could  be replaced by  Turbo  C's  supplied  function
  125. isatty(), however, I plan to extend ISDEV.C to distinguish among files,  CON,
  126. AUX,   and the printer.   The function isatty()  just  distinguishes  between
  127. files and the others.
  128.  
  129. GETDPB.C cannot be compiled in Turbo C's interactive  environment (TC).    It
  130. is   primarily   inline   ASM   code  and  requires  the  more   conventional
  131. environment  provided by  Turbo C's TCC command.   As a  result,    CSAP  was
  132. designed  to  be  compiled  through the  use  of  a  MAKEFILE  and  the  MAKE
  133. facility of Turbo C.
  134.  
  135. CSAP currently  compiles  and  executes correctly  in   any   of   Turbo  C's
  136. supported   memory   models  except HUGE.   The memory model is defined  as a
  137. macro in the MAKEFILE and is supplied  on  the  MAKE command line, i.e.:
  138.  
  139. MAKE -DMDL=s
  140.  
  141. to make a SMALL memory model version of CSAP  (the  "s"  must  be lower  case
  142. since   it   is   a   parameter   to  TCC and TCC is  case  sensitive  on its
  143. parameters).   The resultant  EXE  file  will  be named  CSAPx.EXE where  'x'
  144. is C,   S,   M,  or L depending upon the memory model selected.   The default
  145. memory model  (if -DMDL is not specified on the MAKE command)  is the COMPACT
  146. model.   The  current MAKEFILE will NOT work properly for  the  TINY   memory
  147. model,  the library  specifications in the MAKEFILE would have to be modified
  148. to  use  the SMALL libraries for the TINY model and the  effort  is  probably
  149. not worth it. The command:
  150.  
  151. TCC -mt -G csap sortdir isdevice getdpb
  152.  
  153. would  have   to be used to produce a TINY memory model version of  CSAP  and
  154. would produce an EXE file with the name CSAP.EXE.
  155.  
  156. The  EXE  and OBJ files in the CSAPxxx ZIP have been produced for the COMPACT
  157. model which is probably the most general.
  158.  
  159.  
  160.  
  161.  
  162.